OLA 文档中心

主题

2026-08-20

设置日志格式 - LogSetPattern ​

函数简介 ​

设置日志的输出格式，支持多种占位符自定义日志样式。

接口名称 ​

LogSetPattern

DLL调用 ​

c
int32_t LogSetPattern(int64_t instance, int64_t loggerHandle, const char* logPattern);

参数说明 ​

参数名类型说明
instance长整数型OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
loggerHandle长整数型日志实例句柄（0 表示默认实例）。
logPattern字符串日志格式（为空则使用默认格式）。

支持的占位符 ​

占位符说明
%Y年份（4位数字，如 2026）
%y年份（2位数字，如 26）
%m月份（01-12）
%d日期（01-31）
%H小时（00-23，24小时制）
%I小时（01-12，12小时制）
%M分钟（00-59）
%S秒（00-59）
%e毫秒（000-999）
%f微秒（000000-999999）
%F纳秒（000000000-999999999）
%pAM/PM 标识
%TISO 8601 时间格式（HH:MM:SS）
%v日志消息内容
%l日志级别（TRACE, DEBUG, INFO, WARN, ERROR, CRITICAL）
%L日志级别简写（T, D, I, W, E, C）
%n日志记录器名称
%t线程ID
%P进程ID
%s源文件名
%g源文件短名称（不含路径）
%#源代码行号
%!函数名
%^颜色范围开始标记
%$颜色范围结束标记

示例 ​

使用常见 spdlog 风格格式，再写一条 INFO 验证。

SDK 调用 ​

cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
const int64_t logger = 0; // 默认实例

// 常用格式：时间 + 彩色级别 + 消息
int ret = ola.LogSetPattern(logger, "[%Y-%m-%d %H:%M:%S.%e] [%^%l%$] %v");
if (ret != 1) {
    return;
}
ola.LogInfo("pattern applied");
csharp
using System;
using OLAPlug;

var ola = new OLAPlugServer();
long logger = 0;

// 常用格式：时间 + 彩色级别 + 消息
int ret = ola.LogSetPattern(logger, "[%Y-%m-%d %H:%M:%S.%e] [%^%l%$] %v");
if (ret != 1) return;
ola.LogInfo("pattern applied");
python
from OLAPlugServer import OLAPlugServer

ola = OLAPlugServer()
logger = 0

# 常用格式：时间 + 彩色级别 + 消息
ret = ola.LogSetPattern(logger, "[%Y-%m-%d %H:%M:%S.%e] [%^%l%$] %v")
if ret != 1:
    raise RuntimeError("failed")
ola.LogInfo("pattern applied")
java
import com.olaplug.OLAPlugServer;

OLAPlugServer ola = new OLAPlugServer();
long logger = 0;

// 常用格式：时间 + 彩色级别 + 消息
int ret = ola.LogSetPattern(logger, "[%Y-%m-%d %H:%M:%S.%e] [%^%l%$] %v");
if (ret != 1) {
    return;
}
ola.LogInfo("pattern applied");
go
import "github.com/ola/olaplug/olaplug"

ola, _ := olaplug.NewOLAPlugServer("OLAPlug_x64.dll")
defer ola.ReleaseObj()
logger := int64(0)

// 常用格式：时间 + 彩色级别 + 消息
ret := ola.LogSetPattern(logger, "[%Y-%m-%d %H:%M:%S.%e] [%^%l%$] %v")
if ret != 1 {
    return
}
ola.LogInfo("pattern applied")
rust
use olaplug::OLAPlugServer;

let ola = OLAPlugServer::new("OLAPlug_x64.dll").unwrap();
let logger = 0i64;

// 常用格式：时间 + 彩色级别 + 消息
let ret = ola.log_set_pattern(logger, "[%Y-%m-%d %H:%M:%S.%e] [%^%l%$] %v");
if ret != 1 {
    return;
}
ola.log_info("pattern applied");
cpp
var ola = com("OlaPlug.OlaSoft")
var logger = 0

// 常用格式：时间 + 彩色级别 + 消息
var ret = ola.LogSetPattern(logger, "[%Y-%m-%d %H:%M:%S.%e] [%^%l%$] %v")
if(ret == 1) {
    ola.LogInfo("pattern applied")
}
vbscript
Set ola = CreateObject("OlaPlug.OlaSoft")
logger = 0

' 常用格式：时间 + 彩色级别 + 消息
ret = ola.LogSetPattern(logger, "[%Y-%m-%d %H:%M:%S.%e] [%^%l%$] %v")
If ret = 1 Then
    ola.LogInfo "pattern applied"
End If
text
.局部变量 ola, OLAPlug
.局部变量 ret, 整数型
.局部变量 logger, 长整数型

ola.Create ()
logger ＝ 0

' 常用格式：时间 + 彩色级别 + 消息
ret ＝ ola.LogSetPattern (logger, “[%Y-%m-%d %H:%M:%S.%e] [%^%l%$] %v”)
.如果真 (ret ＝ 1)
    ola.LogInfo (“pattern applied”)
.如果真结束
aardio
import OLAPlugServer;
var ola = OLAPlugServer();
var logger = 0;

// 常用格式：时间 + 彩色级别 + 消息
var ret = ola.LogSetPattern(logger, "[%Y-%m-%d %H:%M:%S.%e] [%^%l%$] %v");
if(ret == 1){
    ola.LogInfo("pattern applied");
}
text
变量 ola <类型 = OLAPlugServer>
ola = 新建 OLAPlugServer
长整数 logger = 0

' 常用格式：时间 + 彩色级别 + 消息
整数 ret = ola.LogSetPattern(logger, "[%Y-%m-%d %H:%M:%S.%e] [%^%l%$] %v")
如果真 (ret ＝ 1)
{
    ola.LogInfo("pattern applied")
}
cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
int64_t logger = 0;

// 常用格式：时间 + 彩色级别 + 消息
int32_t ret = ola.LogSetPattern(logger, "[%Y-%m-%d %H:%M:%S.%e] [%^%l%$] %v");
if (ret != 1) {
    return;
}
ola.LogInfo("pattern applied");

原生 DLL 调用 ​

cpp
long instance = CreateCOLAPlugInterFace();
long logger = 0;

int ret = LogSetPattern(instance, logger, "[%Y-%m-%d %H:%M:%S.%e] [%^%l%$] %v");
if (ret != 1) {
    return;
}
LogInfo(instance, "pattern applied");
csharp
using System.Runtime.InteropServices;

[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long CreateCOLAPlugInterFace();
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogSetPattern(long ola, long loggerHandle, string logPattern);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogInfo(long ola, string message);

long instance = CreateCOLAPlugInterFace();
long logger = 0;

int ret = LogSetPattern(instance, logger, "[%Y-%m-%d %H:%M:%S.%e] [%^%l%$] %v");
if (ret != 1) return;
LogInfo(instance, "pattern applied");
python
from ctypes import CDLL, c_int, c_int64

ola = CDLL("OLAPlug_x64.dll")
ola.CreateCOLAPlugInterFace.restype = c_int64
instance = ola.CreateCOLAPlugInterFace()
logger = 0

ret = ola.LogSetPattern(instance, logger, b"[%Y-%m-%d %H:%M:%S.%e] [%^%l%$] %v")
if ret != 1:
    raise RuntimeError("LogSetPattern failed")
ola.LogInfo(instance, b"pattern applied")

返回值 ​

返回值说明
1成功。
0失败。

注意事项 ​

项目说明
默认格式[%Y-%m-%d %H:%M:%S.%e] [%^%l%$] %v。
修改后立即生效修改后立即生效，如果日志系统已初始化，会自动重新初始化。
%^ 和 %$ 用于控制颜色范围%^ 和 %$ 用于控制颜色范围，仅在控制台输出时有效。
占位符区分大小写占位符区分大小写。
格式格式字符串基于 spdlog 库的格式规范。